<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text-html; charset=Windows-1252">
<title>Related Topics</title>
<style>@import url(coUA.css);</style>
<link disabled rel="stylesheet" href="htmlhelp.css">
</HEAD>

<BODY>
<h1>Related Topics command</h1>

<h2>Purpose</h2>

<p>Displays a list of target topics that a user can jump to. The <b>Item</b> parameter stores information about each target. The list of target topics appears <a href="window_types.htm">on a pop-up menu or in a dialog box</a>.</p>

<p>This command can be used with either a compiled help (.chm) file or uncompiled HTML files.</p>


<h2>Syntax</h2>

<p><pre><code>
&lt;PARAM  name="Command" value="Related Topics [,menu|,dialog]"&gt;
<br>&lt;PARAM  name="Item1"   value="<i>Topic1;Main URL for Topic1;Alternate URL for Topic1</i>"&gt;
<br>[&lt;PARAM name="Button"  value="[Text: <i>Button text</i>|Bitmap: <i>Bitmap file path</i>|Icon:<i>Icon file path</i>]"&gt;]
<br>[&lt;PARAM name="Font"    value="<i><i>Facename[, point size[, charset[, color[, PLAIN BOLD ITALIC UNDERLINE]]]]</i></i>"&gt;]
<br>[&lt;PARAM name="Frame"   value="<i>Frame Name</i>"&gt;]
<br>[&lt;PARAM name="Text"    value="Text: <i>Link text</i>"&gt;]
<!--br>[&lt;PARAM name="Window"  value="<i>Window Name</i>"&gt;]-->
</pre></code></p>

<br>
<table border=1 cellpadding=0 cellspacing=0 width=100%>
<tr valign=top>
<th>
<b>Property</b>
</th>
<th>
<b>Description</b>
</th>
</tr>

<tr valign=top>
<td>
<a href="ocx_pbutton.htm">Button</a>
</td>
<td>
Specifies the button style. Optional.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pcommand.htm">Command</a>
</td>
<td>
Calls the <b>Related Topics</b> command and specifies whether to display target topics <a href="window_types.htm">on a pop-up menu or in a dialog box</a>.

<p>If you do not specify a display option, a dialog box appears by default.</p>

<p>To specify the <b>Topics Found</b> dialog box, type <b>dialog</b>.</p>

<p>To specify a pop-up menu, type <b>menu</b>.</p>
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pfont.htm">Font</a>
</td>

<td>
Specifies the font attributes. Optional.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pframe.htm">Frame</a>
</td>
<td>
Specifies the frame in which to display the selected topic. Optional.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pitem.htm">Item1</a>
</td>
<td>
Specifies the following information about the target topic:
<ul>
<li>Topic title as you want it to appear in the <b>Topics Found</b> dialog box or on a pop-up menu.
<li>Topic file path.
<li>Alternate topic to display if the first topic is unavailable.
</li>
</ul>
<p>Multiple values are delimited by a semicolon.</p>
<p>To specify subsequent topic information, use <b>Item2</b>, </b>Item3</b>, etc.</p>
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_ptext.htm">Text</a>
</td>

<td>
Specifies the link text. Optional.
</td>
</tr>

<!--tr valign=top>
<td>
<a href="ocx_pwindow.htm">Window</a>
</td>
<td>
Specifies the target window in which to display the selected topic. Optional.
</td>
</tr-->
</table>

<h2>Example</h2>
<p><pre><code>
&lt;OBJECT
<br>  id=candomble
<br>  type="application/x-oleobject"
<br>  classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
<br>  codebase="Hhctrl.ocx#Version=4,72,8252,0"
<br>  width=100
<br>  height=100
<br>&gt;
<br>  &lt;PARAM name="Command" value="Related Topics, MENU"&gt;
<br>  &lt;PARAM name="Button" value="Text:See Also"&gt;
<br>  &lt;PARAM name="Item1" value="About Oxala;oxala.html;http://example.microsoft.com/"&gt;
<br>  &lt;PARAM name="Item2" value="About Yemanja;Yemanja.html;http://example.microsoft.com/"&gt;
<br>  &lt;PARAM name="Item3" value="About Oba;oba.html;http://example.microsoft.com/"&gt;
<br>  &lt;PARAM name="Item4" value="About Ogum;ogum.html;http://example.microsoft.com/"&gt;
<br>  &lt;PARAM name="Item5" value="Bad Link;bad_link.html;http://example.microsoft.com/"&gt;
&lt;/OBJECT&gt;
</pre></code></p>

<h2>Sample Related Topics command</h2>

<p><OBJECT id=hhctrl type="application/x-oleobject"
        classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
        width=100
        height=100
>
    <PARAM name="Command" value="Related Topics, menu">
    <PARAM name="Text" value="Text:Click to see related topics">
    <PARAM name="Font" value="Verdana, 8,,#339933, BOLD">
    <PARAM name="Item1" value="ALink command;ocx_alink.htm">
    <PARAM name="Item2" value="KLink command;ocx_klink.htm">
</OBJECT></p>

<h2>Comments</h2>
<ul>
<li>The <b>Button</b> parameter is omitted when this command is invoked by a script.</li>
</ul>

<br>
<table border="0" cellpadding="0" cellspacing="4">
<tr>
<td valign="top"><a href="ocx_commands.htm"><img src="proced.gif" alt="link to overview topic" border="0"></a>
</td>
<td><a href="ocx_commands.htm">About commands</A>
</td>
</tr>
<tr>
<td>&nbsp;</td>
</tr>
</table>

</BODY>
</HTML>
